home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 001 / _serialmse / !SerialMse / !Help next >
Text File  |  1994-03-04  |  6KB  |  188 lines
  1.           ++========================================++
  2.           || Archimedes Serial Mouse Driver V2.10   ||
  3.           ++========================================++
  4.           ||      Stuart Tyrrell 04/03/1994         ||
  5.           ++========================================++
  6.             
  7.  ************************************************************************
  8.  ** This module is Public Domain if, and only if, it is distributed as **
  9.  **           the FULL APPLICATION including this help file.           **
  10.  ************************************************************************
  11.  
  12.  
  13. Introduction
  14. ============
  15.  
  16. This mouse driver is an extension of a project I completed a couple of
  17. years ago. It allows you to connect and use a MS or PC compatible mouse with
  18. your Archimedes via the serial port.
  19.  
  20.  
  21. Use
  22. ===
  23.  
  24. Plug your mouse into the serial port, double click on !SerialMse on a
  25. filer window, and play!.
  26.  
  27.  
  28. Why doesn't it work?
  29. ====================
  30.  
  31. Do you :
  32.  
  33. a) Have an A300/A400/A3000 ?
  34.    - you _may_ need to make a short patch lead as follows, using a 9 pin
  35.    "D" type plug and socket :
  36.    
  37.         9 pin skt (to Arc)              9 pin plug (to mouse)
  38.                 
  39.    +--- 1                               1 ---+
  40.    |    2 ----------------------------- 2    |
  41.    |    3 ----------------------------- 3    |
  42.    +--- 4                               4 ---+
  43.    |    5 ----------------------------- 5    |   
  44.    +--- 6                               6    |
  45.         7 ----------------------------- 7 ---+
  46.         8                               8
  47.         9                               9
  48.  
  49.   I advise you to try your mouse without the lead first - many, especially
  50.   the more expensive, mice work without it.
  51.   
  52.   (You may also need this lead for the newer machines, but probably not)
  53.   
  54.   The link between pins 1,4 & 7 on the mouse end has been added because
  55.   some people have mice that use pin 4. Mine doesn't, and so I can't
  56.   be positive that this fix will work - it should!
  57.         
  58.  
  59. b) Have an A3000?
  60.    - Do you have the serial upgrade fitted? If not, you will need to buy
  61.    one!
  62.    
  63.  
  64. c) Have the "SerialUtils" module loaded (as supplied on the RISC OS 3
  65.    support disk)?
  66.    - For some reason (any ideas?), this version of the mouse driver is
  67.    incompatible with this module. RMKill SerialUtils, and don't load it
  68.    as part of your boot sequence anymore.
  69.    
  70.  
  71. Points to note
  72. ==============
  73.  
  74. The MS standard only allows for two buttons. Therefore an MS mouse will
  75. either only have 2 buttons, or the middle button will not work! To emulate
  76. pressing the middle mouse button, press the left and right button on the
  77. MS mouse at the same time. Of course, the lucky among you will have a
  78. mouse which has a middle button which does just that (see your MS mouse
  79. manual for details), and so the middle button will function as normal.
  80.  
  81. The three button "PC-Mouse" standard mice have a third button which
  82. functions as normal.
  83.  
  84. Auto-detection of mice is now standard. The module will make an intelligent
  85. guess as to which mouse you have fitted. Changing between the two mouse
  86. standards may occur at any time, but it is better not to switch a switchable
  87. mouse while the module is loaded - mouse movement may be undefined for a
  88. short time while the module gets re-synchronised.
  89.  
  90. This version of the module also supports mouse acceleration, via
  91. "*SerialMouseAcc". I was loathe to put this in, but a number of people
  92. asked for it, and it was simple to implement it. If you would rather
  93. use one of the "standard" mouse accelerators, then just leave the one
  94. in the module turned off, and load your preffered mouse accelerator.
  95.  
  96.  
  97. * Commands
  98. ==========
  99.  
  100. There are two * commands. The first, "*SerialMouseType", will give
  101. you information as to which type of mouse the module thinks you have
  102. connected, and allow you to force it to think otherwise if need be :
  103.  
  104. *SerialMouseType
  105. -- Shows the current mouse type (PC or MS) and whether type detection is
  106.    automatic or forced.
  107.    
  108. *SerialMouseType AUTO
  109. -- Use the module's auto-detection system to determine the type of mouse
  110.    connected.
  111.    
  112. *SerialMouseType MS
  113. -- Force the module to think it has a MS type mouse attached.
  114.  
  115. *SerialMouseType PC
  116. -- Force the module to think it has a PC-3 button type mouse attached.
  117.  
  118.  
  119. The second * command, "*SerialMouseAcc" allows you to turn the mouse
  120. acceleration on and off :
  121.  
  122. *SerialMouseAcc
  123. -- Shows you whether the mouse acceleration is currently on or off.
  124.  
  125. *SerialMouseAcc ON
  126. -- Turn on the mouse acceleration.
  127.  
  128. *SerialMouseAcc OFF
  129. -- Turn off the mouse acceleration.
  130.  
  131. There is a line in !Run within the application which allows you to turn
  132. the acceleration on or off when the module is first loaded.
  133.  
  134.  
  135. Contact
  136. =======
  137.  
  138. Stuart Tyrrell
  139. 6 Stamford Close
  140. Market Deeping
  141. Peterborough
  142. Cambs.
  143. PE6 8AF
  144.  
  145. (note this is a change from my previous address in St. Helens).
  146.  
  147. Email (until June 1994 at least!)
  148. stl@sn2.ee.umist.ac.uk
  149.  
  150.  
  151. Versions
  152. ========
  153.  
  154. V0.01 (03/11/92) - First version
  155. V0.02 (21/02/94) - Tidied up serial setup routines
  156.                  - Move 'x'  then 'y' so movements outside bounding box still
  157.                    allow some movement
  158.                  - Found incompatability with SerialUtils
  159.                  - Documentation
  160.                  - Release
  161. V1.00 (24/02/94) - Implemented PC mouse driver module.
  162.                  - Revised docs
  163.                  - Release
  164. V1.00/1.01 (25/02/94)
  165.                  - Split version numbers into MS/PC mouse modules
  166.                  - PCMouse update now much smoother (V1.01)
  167.                  - Documentation update
  168.                  - Release
  169. V1.01/1.01 (27/02/94)
  170.                  - Forced MS-Mouse to work at 8N1 rather than 7N1
  171. V1.02 (27/02/94)
  172.                  - Autodetection of mice now implemented.
  173.                  - Back to single version number as only one module!
  174. V2.00 (28/02/94)
  175.                  - Implemented *SerialMouseType
  176.                  - Packaged into application
  177.                  - Documentation
  178.                  - Release
  179. V2.10 (04/03/94)
  180.                  - Mouse keys now fully emulated (-ve inkey numbers,
  181.                     key up/down events etc). Now you can play Lemmings!
  182.                  - Changes in MOUSE STEP (OS_Word 21,2) now work - module
  183.                     uses configured mouse step on start-up, and traps
  184.                     all MOUSE STEP changes after.
  185.                  - Mouse acceleration implemented.
  186.                  - Doc update to include pins 1,4 & 7 on mouse side.
  187.                  - Release
  188.